home *** CD-ROM | disk | FTP | other *** search
/ Software of the Month Cl… (Business) 1997 November / Software of the Month Club - Business Shareware (Volume 243) (November 1997).iso / dos / Utility / SEE / EXAMPLES.DOC < prev    next >
Encoding:
Text File  |  1996-07-19  |  8.2 KB  |  159 lines
  1. ::XFM
  2.  
  3.    ===========================================================================
  4.    ===================                                      ==================
  5.    ===================       THE /F AND /M PARAMETERS       ==================
  6.    ===================                                      ==================
  7.    ===========================================================================
  8.  
  9.    COMMAND FORMAT          PURPOSE
  10.    ----------------------  ---------------------------------------------------
  11.    SEE file /Ftext         Finds the specified text
  12.    SEE file /M             Switches on monochrome (black and white) display
  13.    ----------------------  ---------------------------------------------------
  14.  
  15.    This demonstration will load the file SEE.DOC (the SEE manual), find the
  16.    words "has a space" and highlight the line.  Since the text we are looking
  17.    for contains spaces, we must enclose the search text in quotations.  We
  18.    will also use the /M switch to put SEE into monochrome (black and white)
  19.    mode.  If you have already put SEE in monochrome mode (via the SEESETUP
  20.    program), the /M switch will have no effect.
  21.  
  22.    The command we will use is:
  23.  
  24.                           SEE SEE.DOC /M /F"has a space"
  25.  
  26.    Since the /M switch only temporarily affects SEE, it will not affect the
  27.    other demonstrations.  After SEE has located the text, you can press the
  28.    Esc (Escape) key to return to the examples menu.
  29.  
  30. ::XK
  31.  
  32.    ===========================================================================
  33.    ==================                                       ==================
  34.    ==================             THE /K PARAMETER          ==================
  35.    ==================                                       ==================
  36.    ===========================================================================
  37.  
  38.    COMMAND FORMAT          PURPOSE
  39.    ----------------------  ---------------------------------------------------
  40.    SEE file /Kkey-list     Stacks keys to be "pressed automatically"
  41.    ----------------------  ---------------------------------------------------
  42.  
  43.    This demonstration will load the file SEE.DOC (the SEE manual) and stack
  44.    the "End" and "PgUp" key, so we will see the manual one screen up from the
  45.    end of the file.  The command to do this is:
  46.  
  47.                            SEE SEE.DOC /K{END}{PGUP}
  48.  
  49.    After SEE has positioned itself, you can press the Esc (Escape) key to
  50.    return to the examples menu.
  51.  
  52. ::XO
  53.  
  54.    ===========================================================================
  55.    ==================                                       ==================
  56.    ==================           THE /O PARAMETER            ==================
  57.    ==================                                       ==================
  58.    ===========================================================================
  59.  
  60.    COMMAND FORMAT          PURPOSE
  61.    ----------------------  ---------------------------------------------------
  62.    SEE file /Oconfig-list  Temporarily modifies configuration items
  63.    ----------------------  ---------------------------------------------------
  64.  
  65.    This demonstration will use the /O parameter to temporarily override
  66.    configuration values for the main viewscreen color (code MVRGTX), the text
  67.    of the end of file marker (code EOFMRK), and the color of the screen after
  68.    the end of the file (code EOFBCO).  We will view the file READ.ME (an
  69.    introductory file supplied with the standard version of SEE) to see the
  70.    difference.  The command we will use is:
  71.  
  72.             SEE READ.ME /o"!MVRGTX!MbWk!EOFMRK! The End !EOFBCO!gbkL"
  73.  
  74.    We have to enclose the parameter specification in quotes, because it
  75.    contains spaces.  The changes could be saved to the current CFG file by
  76.    including the /W (write configuration change) switch in the command.
  77.  
  78. ::XU
  79.  
  80.    ===========================================================================
  81.    ==================                                       ==================
  82.    ==================           THE /U PARAMETER            ==================
  83.    ==================                                       ==================
  84.    ===========================================================================
  85.  
  86.    COMMAND FORMAT          PURPOSE
  87.    ----------------------  ---------------------------------------------------
  88.    SEE file /Ufilename     Specifies alternative menu (MNU) file
  89.    ----------------------  ---------------------------------------------------
  90.  
  91.    SEE's default menu definition (MNU) file is named SEE.MNU.  This demon-
  92.    stration will use the /U parameter to point to a different MNU file, named
  93.    SEESAMPL.MNU. The file we view will be the alternative MNU file itself, so
  94.    you can study how it changes the behaviour of SEE.  The command we use is:
  95.  
  96.                           SEE SEESAMPL.MNU /uSEESAMPL
  97.  
  98.    The SEESAMPL.MNU file contains numerous comments, which explain what it
  99.    does and how it works.  One of the changes performed by the SEESAMPL.MNU
  100.    menu definition file is to turn off the pull-down menus.  So after viewing
  101.    the file, the only way to get out is to press the Esc (Escape) key.
  102.  
  103. ::XX
  104.  
  105.    ===========================================================================
  106.    ==================                                       ==================
  107.    ==================           THE /X PARAMETER            ==================
  108.    ==================                                       ==================
  109.    ===========================================================================
  110.  
  111.    COMMAND FORMAT          PURPOSE
  112.    ----------------------  ---------------------------------------------------
  113.    SEE file /X             Switches on raw text (binary file) display mode
  114.    ----------------------  ---------------------------------------------------
  115.  
  116.    SEE normally displays text files in text mode.  If, however, you wish to
  117.    see a file in "raw text" mode, you can use the /X switch.  This is useful
  118.    for scanning executable (EXE) files.  SEE normally detects non-text files
  119.    automatically, but in the rare instances where it makes the wrong
  120.    decision, the /X switch will force it into raw text mode.  We will view
  121.    the file SEESETUP.EXE, using this command:
  122.  
  123.                               SEE SEESETUP.EXE /X
  124.  
  125.    While viewing the file, try out the "Textify" feature (on the Text
  126.    pull-down menu -- short-cut key Alt-Y).  The textify function filters out
  127.    most of the non-human-readable material in binary files.  This makes it
  128.    easy to visually scan the file for intelligible text.
  129.  
  130. ::XNQP
  131.  
  132.    ===========================================================================
  133.    ==================                                       ==================
  134.    ==================       THE /N /Q AND /P PARAMETERS     ==================
  135.    ==================                                       ==================
  136.    ===========================================================================
  137.  
  138.    COMMAND FORMAT          PURPOSE
  139.    ----------------------  ---------------------------------------------------
  140.    SEE file /Nprefix-list  Lists up to five prefixes for "no-show" lines
  141.    SEE file /Ftext         Finds the specified text (regular or no-show)
  142.    SEE file /Qtext         Stops reading in text when specified text is found
  143.    SEE file /P             Switches on printer-code filtering
  144.    ----------------------  ---------------------------------------------------
  145.  
  146.    This demonstration will use the /N and /Q parameters to zero in on a
  147.    particular section of the SEE manual (SEE.DOC), which includes special
  148.    hyperdocumentation codes (e.g. ::HYPER).  The SEE.DOC file contains the
  149.    form feed character (ASCII 12) so that if it is printed, it will generate
  150.    page ejects in appropriate places.  To filter these out, we will use the /P
  151.    switch to remove printer control characters.  Thus, the command is:
  152.  
  153.                        SEE SEE.DOC /N!:: /F::HYPER /Q /P
  154.  
  155.    When the /Q parameter is used in No-Show (/N) Mode without a specification
  156.    (i.e. it is not given specific text to look for), SEE will stop reading
  157.    text when it encounters the next No-Show line (or the end of file).
  158.  
  159.